home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Utilities / Workspace / AltDock / ReadMe.txt < prev    next >
Text File  |  1995-06-12  |  3KB  |  71 lines

  1. AltDock
  2.     by
  3.         Jayson Adams
  4.             Academic Information Resources
  5.                     Stanford University
  6.  
  7. This program creates an "Alternate Dock" at the left-hand side of the NeXT
  8. screen.  Just like the NeXT dock, the Alternate Dock maintains windows (which
  9. float above all others except menus) that represent applications. Double-
  10. clicking one of these windows runs or unhides the corresponding application.
  11. The Alternate Dock always has at least one window (called the "Dock" window,
  12. and similar to the "NeXT" cube window at the top of the "real" dock).  Dragging
  13. this window moves all of the Alternate Dock's windows.  The Alternate Dock is
  14. two-dimensional (instead of 1-D in the NeXT-supplied dock) so you can place
  15. windows along both the X and Y axes and also move the dock along those axes.  Double-clicking the "Dock" window will cause AltDock's menu to disappear or
  16. reappear.
  17.  
  18. A file named .altdock in your home directory tells AltDock where to place
  19. its windows.  Each window requires two, \n-terminated lines of the form:
  20.  
  21. x y
  22. /NextApps/SomeApplication
  23.  
  24. x and y above are coordinates in a "grid", with (0,0) located at the NeXT
  25. screen's lower-left corner, and positive X extending to the right, positive
  26. Y extending up.  AltDock will create a window for this application based
  27. on these coordinates (for example, specifying (0,0) will cause a window to
  28. appear in the lower-left corner, (-1,1) will cause a window to appear to the
  29. left one grid position (64 pixels) and up one grid position).
  30.  
  31. The next line specifies the application's absoulte path name.  Note that
  32. you must specify an application name, not something ending in .app (for
  33. example, the path name for WriteNow must be /NextApps/WriteNow.app/WriteNow).
  34. When AltDock runs, it will ask the WorkSpace for this application's icon and
  35. create a window located at (x,y) within the AltDock grid.
  36.  
  37. The .altdock file must also specify the location of the "Dock" window.
  38. Specify coordinates as usual, but "Dock" should be application name.
  39. Here's a sample .altdock file:
  40.  
  41. 0 0
  42. /NextApps/Terminal
  43. 0 3
  44. Dock
  45. 0 2
  46. /Users/surak/Apps/LockScreen
  47. -1 -1
  48. /NextDeveloper/Demos/Scene
  49.  
  50. AltDock uses Speaker/Listener methods to run and unhide programs, and
  51. therefore suffers from certain limitations:
  52.  
  53.     1. When AltDock runs a program, a second miniwindow icon appears
  54.        on the screen.  Double-clicking either this window or the window
  55.        in the AltDock will unhide the application, so you don't really
  56.        need to keep the application's true miniwindow around.  You can
  57.        hide it somewhere (behind the AltDock, for instance) to avoid
  58.        cluttering the screen.
  59.     2. AltDock can't tell when you quit a program that it started.
  60.     3. While you can keep copies of the same app. icon in the NeXT dock
  61.        (so you can easily create multiple instances of the same program), 
  62.        you won't gain anything by doing that with AltDock:  when you
  63.        double-click an AltDock icon, it searches for an existing instance
  64.        of that application.
  65.        
  66. Despite AtlDock's imperfections, it should be useful.  Please send any
  67. comments to surak@jessica.stanford.edu.  Enjoy!
  68.  
  69. __jayson adams  :-)
  70.  
  71.